package xyz.ssf.cloud.project.system.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import xyz.ssf.cloud.project.system.domain.SysRole;
import xyz.ssf.cloud.project.system.domain.dto.RoleQuery;

import java.util.List;

/**
 * 角色表数据访问层
 */
@Mapper
public interface SysRoleMapper {
    
    /**
     * 根据条件分页查询角色列表
     *
     * @param query 查询条件
     * @return 角色信息集合
     */
    List<SysRole> selectRoleList(RoleQuery query);
    
    /**
     * 查询所有角色
     *
     * @return 角色列表
     */
    List<SysRole> selectRoleAll();
    
    /**
     * 根据用户ID查询角色
     *
     * @param userId 用户ID
     * @return 角色列表
     */
    List<SysRole> selectRolesByUserId(Long userId);

    /**
     * 根据角色ID查询角色
     *
     * @param roleId 角色ID
     * @return 角色对象信息
     */
    SysRole selectRoleById(Long roleId);
    
    /**
     * 根据角色编号查询角色
     *
     * @param roleCode 角色编号
     * @return 角色对象信息
     */
    SysRole selectRoleByCode(String roleCode);
    
    /**
     * 根据角色名称查询角色
     *
     * @param roleName 角色名称
     * @return 角色对象信息
     */
    SysRole selectRoleByName(String roleName);
    
    /**
     * 新增角色信息
     *
     * @param role 角色信息
     * @return 结果
     */
    int insertRole(SysRole role);
    
    /**
     * 修改角色信息
     *
     * @param role 角色信息
     * @return 结果
     */
    int updateRole(SysRole role);
    
    /**
     * 修改角色状态
     *
     * @param role 角色信息
     * @return 结果
     */
    int updateRoleStatus(SysRole role);
    
    /**
     * 批量删除角色信息
     *
     * @param roleIds 需要删除的角色ID
     * @return 结果
     */
    int deleteRoleByIds(Long[] roleIds);
    
    /**
     * 删除角色信息
     *
     * @param roleId 角色ID
     * @return 结果
     */
    int deleteRoleById(Long roleId);

    /**
     * 查询角色关联的用户数量
     *
     * @param roleId 角色ID
     * @return 结果
     */
    int countUserRoleByRoleId(Long roleId);
    
    /**
     * 根据条件查询角色总数
     *
     * @param query 查询条件
     * @return 角色总数
     */
    int countRoleList(RoleQuery query);
} 